Space Butler

Powerful automation capabilities for Trello

Welcome, and thank you for your interest in Space Butler.

This app provides automation services to complement existing Trello Automation capabilities via the HTTP Request.

It is called from within your automation rules and commands where a http request can be used. It can also be called from any software that supports http request. An example would be to use iOS Shortcut to get a card details using the card url.

space butler icon

The available services aka addon capabilities are curated by the developer.

The app can be found on Deta Space on its Discovery page at https://deta.space/discovery/@milynnus/space_butler

More details of the services available from Space Butler can be found on at this link : https://dojo.hipposites.com/space-butler/home

Services documentation

Each service documentation contains the following :

Description

This is a short description services provided by the endoint.

The services are logically grouped and each group is a Deta Micro using FastAPI to provide the api services therein. See Path…

Trello Http Request will require :

  • URL of your instance of Space Butler,
  • the Path,
  • the endpoint,
  • Request Method and
  • the Payload.

Path

Here’s an example of a URL for a http request :

https://husky-yqs8-space_butler.milynnus.deta.app/location/update_location

where

  • your Space Butler instance endpoint is https://husky-yqs8-space_butler.milynnus.deta.app
  • path for the micro is /location (this is how the services are logically implemented)

Endpoint Path

Here’s an example of a URL for a http request : https://husky-yqs8-space_butler.milynnus.deta.app/location/update_location

  • endpoint for service is /update_location

Use Cases

One or more use cases may be provided.

  • Brief description of use case 1
  • Brief description of use case 2
  • Brief description of use case 3

Request Method

In most cases, the request will be a POST http request. The option is provided from within Trello Automation > Content > Http Request.

Unless otherwise specific, no headers are required.

Your API Key and Token you provide will be store on your personal, private cloud in Deta Space.

Payload

{“card_id” : "{triggercardidlong}", “address” : "60 Lincoln Center Plaza, New York, NY 10023, United States", “locationName” : “The Juilliard School”}

In the above case, the {triggercardidlong} is a Trello variable and when the request is called, Trello automation will insert the value of the card id.

In Trello, the following prefixes are commonly used : {trigger…} {copy…} {new…} {multiplier…} {previous…} etc For more information on Trello variables, visit this help page.

Query Parameter(s)

Where query parameters are used, it is appended to the url e.g https://husky-yqs8-space_butler.milynnus.deta.app/location/update_location?country=usa&zip=10023 where the query paramters is appended aka ?country=usa&zip=10023

You can use Trello variables e.g ?country={{%Country}}&zip={{%Zip}} where you have the country and zip values on the card as Custom Fields.

Http Response

In most cases, the response would be just

{“result” : “OK”}

However, you can get a response like

{“cardlink” : “https://trello.com/c/sadjshdj” , “value” : “1234”}

and you can use the variables {httpresponse.cardlink} or {httpresponse.value} in your downstream automation.

You can read more about Trello Http Request here.

Special Instructions

After you select to install Space Butler from Space Discovery a copy of Space Butler will appear on your canvas :

  • click on the 3 dots of Space Butler
  • click on “Settings”
  • click on “Configuration”
  • Copy and paste your Trello API Key and Token and save the information provided

For instructions on how to create your API and Token follow this link. Use the copy down both your Personal Key and Token . For the token, under the Token section use the manually generate a Token link generate a new token after you have authorize access to your boards by clicking on the Allow button shown.

At this point, if you go to View Data, you will probably not see a copy of your API Key and Token stored in a Deta Base "space_butler_config". A copy will be created and subsquently updated should you decide to change either the API Key and/or Token.